home *** CD-ROM | disk | FTP | other *** search
/ The Arsenal Files 6 / The Arsenal Files 6 (Arsenal Computer).ISO / spitfire / sfrom22b.zip / UTILITY.ZIP / EZREQ.DOC next >
Text File  |  1996-01-14  |  12KB  |  260 lines
  1.  
  2.                               EZ-Request
  3.                              Version 1.00
  4.                           Released Feb 3, 1994
  5.  
  6.                  Copyright 1994 - 1996 by Michael Robinson
  7.                        Internet: TheMikeRob@aol.com
  8.  
  9.                             The Soft Parade
  10.                         Shelton, Connecticut, USA
  11.                         1:141/485    203-924-5603
  12.                         1:141/486    203-922-1794
  13.               Fast Online registration using Visa or Mastercard
  14.  
  15.       EZ-Request is a free utility for registered versions of the EZ-ROM
  16.       and SF-ROM Doors. It is an automatic file request fulfillment manager
  17.       and file request database editor.
  18.  
  19. ----- PROGRAM OPERATION -------------------------------------------------
  20.  
  21.       Simply place EZREQ.EXE in the home directory of either EZ-ROM or
  22.       SF-ROM and run it. EZ-Request looks for either EZROM.REQ or SFROM.REQ
  23.       which is the request log database file created the first time a
  24.       caller requests a file. It first looks in the current directory, then
  25.       it looks in the directory that EZREQ.EXE is located in, and finally
  26.       it searches the DOS path. If neither .REQ file is found then
  27.       EZ-Request beeps, diplays an info screen, and then halts. EZROM.REQ
  28.       and SFROM.REQ are only created by registered versions of the EZ-ROM
  29.       and SF-ROM doors.
  30.  
  31.       The main program screen looks like this:
  32.  
  33.       EZ-Request Editor 1.00  Copyright 1994 Mike Robinson
  34.  
  35.       Record Number 12 of 33           There are 4 Requests Pending.
  36.  
  37.       <1> Reading File....... C:\CDROM\EZROM.REQ
  38.       <2> Use CD-ROM Drive... E
  39.       <3> Copy To Directory.. C:\CDROM\REQUEST
  40.       <4> Request Status..... REQUEST
  41.       <5> Request Date....... 01-31-94
  42.       <6> Caller Name........ John Smith
  43.       <7> CD Disk Name....... Night Owl 10
  44.       <8> Original CD Path... E:\DIR1\BIG-GAME.ZIP
  45.       <9> File Description... Action adventure game, excellent graphics
  46.  
  47.       <F> Fill Request
  48.       <S> Skip Request
  49.       <+> Next Record
  50.       <-> Previous Record
  51.       <Q> Quit
  52.  
  53.       Your Command: _
  54.  
  55.       The program is menu driven. Use the <Enter> + and - keys to move from
  56.       record to record. Enter any number from 1 to 9 to change the
  57.       corresponding field in the upper section. Enter F to fill the current
  58.       request, S to skip the current requests and advance to the next
  59.       record. Enter Q or <escape> to exit the program. Pressing escape at
  60.       any point aborts the current operation.
  61.  
  62.       The CD-ROM working drive is where the files will be copied from.
  63.       To change the CD-ROM drive enter 2. The default CD-ROM drive is
  64.       the same as the original CD-ROM drive in number <8>. In some cases
  65.       you may have requests from different drives, so the CD-ROM drive
  66.       letter will change to follow the original drive for that disk.
  67.       If you manually change the CD-ROM drive from inside the program,
  68.       from the DOS command line, or in the configuration file then the
  69.       CD-ROM drive will become fixed until the next time you manually
  70.       change it.
  71.  
  72.       Note to Pioneer CD-ROM disk changer owners: you can buy an additional
  73.       cartridge and load it with all your offline disks. So you might have
  74.       six online disks in one cartridge and six offline disks in the other.
  75.       When it comes time to fill the requests, you can just swap
  76.       cartridges and the working drive will automatically switch to the
  77.       correct drive letter.
  78.  
  79.       When filling a request, the program will fill the current request if
  80.       the status is REQUEST, othewise it will jump to the next REQUEST on
  81.       the same CD-ROM disk. Once all the requests on the same disk have
  82.       been presented, the program will jump to the next REQUEST on any
  83.       disk.
  84.  
  85.       Menu option <4> is the status of the current request, which will be
  86.       one of 3 possible status values:
  87.  
  88.       REQUEST ...The caller has requested the file, but the request has not
  89.                  yet been filled by the sysop.
  90.  
  91.       PENDING ...The sysop has filled the request, the file has been copied
  92.                  to the hard drive request holding directory (RequestDir).
  93.                  The caller will be notified that this file is available
  94.                  for download the next time the caller enters the door.
  95.  
  96.       DONE ......The caller has downloaded the file.
  97.  
  98.       You can change the status manually if required, but in general the
  99.       status will be automatically updated. EZ-Request will automatically
  100.       change the status from REQUEST to PENDING when it successfully copies
  101.       a file to the hard drive and fills a request. The door will change
  102.       the status from PENDING to DONE when the caller exits the door after
  103.       downloading the pending file.
  104.  
  105.       EZ-Request uses file sharing and record locking if you set Share ON
  106.       in EZREQ.CFG. If you have loaded DOS SHARE.EXE in your CONFIG.SYS or
  107.       AUTOEXEC.BAT, then it is safe to use EZ-Request while a caller is in
  108.       the door. But if you change a record that applies to the caller in
  109.       the door, the record may be changed again by the door when the caller
  110.       exits or places a request. Old records may also be overwritten (and
  111.       old pending files deleted) as part of the maintenance procedure that
  112.       occurs during exit from the door. Do NOT use EZ-Request with a caller
  113.       in the door if you do not have both Share ON in EZROM.REQ and DOS
  114.       SHARE.EXE loaded.
  115.  
  116.       The caller will only be notified that a file is ready for download if
  117.       the request status is PENDING when the caller enters the door. You
  118.       can fill a request with the caller in the door and then the caller
  119.       can download the files by using the Utility menu to check for
  120.       requested files.
  121.  
  122.  
  123. ----- COMMAND LINE (Optional) -------------------------------------------
  124.  
  125.       EZ-Request also accepts the following optional command line
  126.       parameters:
  127.  
  128.       EZREQ  [CD-ROM Drive Letter]  [Request Directory]  [Request Log]
  129.  
  130.       Examples:
  131.  
  132.       EZREQ
  133.       EZREQ  E
  134.       EZREQ  E  C:\CDROM\REQUEST
  135.       EZREQ  E  C:\CDROM\REQUEST  C:\CDROM\EZROM.REQ
  136.  
  137.       CD-ROM Drive Letter ..... The files will be copied from this drive.
  138.  
  139.       Request Directory ....... The files will be copied to this directory.
  140.                                 A trailing backslash is not required.
  141.                                 Use of this command is rarely necessary
  142.                                 since the RequestDir is saved in the .REQ
  143.                                 file when the caller makes a request.
  144.  
  145.       Request Log ............. Database file of all file requests.
  146.                                 Usually EZROM.REQ or SFROM.REQ.
  147.                                 Use of this command is not necessary if the
  148.                                 .REQ file is in the current directory.
  149.  
  150.       Because the command line parameters are separated by blank spaces, in
  151.       order to specify parameter 2, parameter 1 must also be specified. In
  152.       order to specify parameter 3, all of the parameters must be
  153.       specified.
  154.  
  155.       The command line overides any settings made in the configuration
  156.       file. All of the command line parameters and configuration file
  157.       parameters can be changed inside the program.
  158.  
  159.  
  160. ----- CONFIGURATION FILE EZREQ.CFG (Optional)----------------------------
  161.  
  162.       EZ-Request looks for the optional configuration file EZREQ.CFG in the
  163.       current directory, then it looks in the directory that EZREQ.EXE is
  164.       located in, and finally it searches the DOS path. If found, the
  165.       program reads each line and if it begins with a configuration
  166.       command, then the configuration is modified as directed by the
  167.       command. If a line begins with anything other than a letter, it is
  168.       ignored. The explanatory comments are on lines beginning with a
  169.       semicolon and are therefore ignored. The commands are NOT case
  170.       sensitive, but they must be spelled correctly. The order of the lines
  171.       is not important.
  172.  
  173.  
  174.    DRIVE  E
  175.  
  176.       Sets the CD-ROM drive letter.
  177.       Same as first command line parameter.
  178.       The files will be copied from this drive.
  179.       A trailing colon (like E:) is not required and will be ignored.
  180.       Default is drive E.
  181.  
  182.  
  183.    REQUESTDIR   C:\CDROM\REQUEST
  184.  
  185.       The files will be copied to this directory.
  186.       Same as the second command line parameter.
  187.       A trailing backslash is not required and will be ignored.
  188.       Use of this command is rarely necessary since the RequestDir is saved
  189.       in the .REQ file when the caller makes a request.
  190.  
  191.  
  192.    REQUESTLOG   C:\CDROM\EZROM.REQ
  193.  
  194.       Database file of all file requests.
  195.       Same as the third command line parameter.
  196.       Usually EZROM.REQ or SFROM.REQ.
  197.       Use of this command is not necessary if the .REQ file is in the
  198.       current directory.
  199.  
  200.  
  201.    MAPHOLDDRIVE  ON
  202.  
  203.       This command is primarily aimed at network users. If you run
  204.       EZ-Request from across a network, the request directory (RequestDir)
  205.       drive letter will be changed (mapped) to the apparent drive letter of
  206.       the drive containing EZROM.REQ. So if the machine with EZROM.REQ
  207.       "looks like" drive F from across the network, then the files will be
  208.       copied to the RequestDir directory on apparent drive F.
  209.       Set MapHoldDrive OFF to disable this behavior.
  210.       Default is MapHoldDrive ON.
  211.  
  212.  
  213.    SHARE ON
  214.    SHARE OFF
  215.  
  216.       Optional. Choose one. Turns file sharing and locking ON or OFF.
  217.       If you have more than 1 node, or you want to fill requests while a
  218.       caller is in the door, then set Share ON. In order for file sharing
  219.       and locking to work, you must use DOS 3.1 or higher, and DOS
  220.       SHARE.EXE must be loaded in your CONFIG.SYS or AUTOEXEC.BAT.
  221.       If file sharing is not required, then you may set Share OFF.
  222.       Default is Share OFF.
  223.  
  224.  
  225.    MAXBUFF 64000
  226.  
  227.       Optional. Determines the maximum file copy buffer size in bytes. Most
  228.       systems work well with the default value of 64000 bytes. This is the
  229.       maximum buffer size. The actual buffer is created just before copying
  230.       a file and is sized to fit within the DOS conventional (low) memory
  231.       available at that moment. Some networks, CD-ROM drives, and CD-ROM
  232.       software drivers may give better performance if you reduce the
  233.       MaxBuff. If you are experiencing a problem when the program copies
  234.       large files, then try reducing the MaxBuff to 32000 or 16000 bytes.
  235.       The smaller buffer may be a better match with the other CD-ROM
  236.       related buffers used in your system.
  237.       Values from 500 to 65500 bytes are allowed.
  238.       Default is 64000 bytes.
  239.  
  240.  
  241.    DIRECTVIDEO   ON
  242.    BIOSSCROLL    ON
  243.    CHECKSNOW     OFF
  244.  
  245.       The defaults are shown. These commands are the same as described in
  246.       EZROM.DOC or SFROM.DOC.
  247.  
  248.  
  249.       Special Note to PIONEER CD-ROM disk changer owners:
  250.       You can buy an additional cartridge and load it with all your offline
  251.       disks. So you might have six online disks in one cartridge and six
  252.       offline disks in the other. When it comes time to fill the requests,
  253.       you can just swap cartridges and the working drive will automatically
  254.       change to the correct disk. In order for this to work, you must NOT
  255.       manually change the specified working CD-ROM drive via the command
  256.       line, via the configuration file, or from inside the program. If you
  257.       change the working CD-ROM drive at any time, the working drive will
  258.       stick on that drive until the next time you manually change the drive.
  259.  
  260.